home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / to_day19.zip / TO-DAY.DOC < prev    next >
Text File  |  1991-01-08  |  4KB  |  92 lines
  1.                              TO-DAY
  2.                          by Roland Haley  
  3.  
  4.                       Release 1.07 01/08/91
  5.  
  6.  
  7. This  program determines the current date, then reads data  files 
  8. containing  historical facts and produces a file  of  interesting 
  9. information about the current date.  It is intended for use  with  
  10. PCBoard 14.5 systems. The files are created using the HEXADECIMAL
  11. codes so there is only one file to worry about.  This can be your 
  12. NEWS file, or any other that you choose.
  13.  
  14. Plus, it also creates a  LOGOFF  file which is a one or two liner 
  15. when the user logs off your system. Each day is different. To get
  16. the log-off files  (if not already on your system)  call  Haley's
  17. Comment BBS.
  18.  
  19. TO-DAY.EXE  will read a file created just for your system, called
  20. "TODAY.LCL"  and  placed in the same path as the other  TODAY.xxx
  21. files.  In this file you enter the birthdates of your members and
  22. any other item for the entire year. Just follow the format of the
  23. sample file.   In this way, you may "customize" your display with
  24. special events or reminders you desire,  without  having  to edit
  25. the monthly files.
  26.  
  27. SETTING UP:
  28.  
  29. The only elements that need to be set up to operate this  program 
  30. are the TODAY.LCL file and the TODAY.CFG  file.  These files MUST 
  31. be located in the current logged directory whenever TO-DAY.EXE is
  32. executed.   
  33.  
  34. The TODAY.CFG only requires three lines.The first line containing
  35. the name of your BBS, and the second line containing the path and
  36. name of the file you want to write to,  and the third,  your path
  37. to the SCRIPT0 file. eg.
  38.  
  39. Haley's Comment BBS     <= Name of YOUR BBS
  40. D:\NEWS\0NEWS           <= Path & name of file to write to
  41. D:\SCRIPT               <= Path of your SCRIPT0 file
  42.  
  43. But if you wish to change the color of the printed file, then add
  44. three extra lines. eg.
  45.  
  46. @X0F                    <= Color of main title
  47. @X0E                    <= Color of sub title
  48. @X0B                    <= Color of messages
  49.  
  50. TESTING:
  51.  
  52. To test the program, simply type TO-DAY  <enter> and the output
  53. file  you  have  named  in  the  TODAY.CFG file will be created
  54. (or overwritten if it already exists), and so  will the SCRIPT0
  55. file.
  56.  
  57. OPERATION:
  58.  
  59. The recomended operation of  TO-DAY.EXE  is have it called from
  60. the  EVENT.SYS  file  during  your  automatic daily maintenance
  61. shortly after midnight.  Add these two lines to your  EVENT.SYS
  62.  
  63.  
  64. CD \NEWEVENT <--- You should change this to the directory where 
  65.                   TODAY.CFG will be located.
  66. TO-DAY.EXE   <--- Next, execute the program, which will get the
  67.                   date  from  the  system clock and produce the 
  68.                   output file(s) as specified in TODAY.CFG.
  69.  
  70. SPECIAL NOTE:
  71.  
  72. This program uses data files which are based on a data format and 
  73. content used by a number of similar programs. Consequently, other
  74. sources  produce  data  files  compatible  with  this format, and
  75. you may wish to merge them into these files.  Avoid  duplication,
  76. or  both  entries  will be displayed in your output file.   Also,
  77. be cautious about SORTING the new entries,  as the  SORT  routine
  78. may  be  confused  by  the  sequence of some of the multiple line 
  79. entries in these or other data files.
  80.  
  81. This program is free for you to use as you wish.  But please call
  82. Haley's Comment BBS  at either of the numbers listed  below,  and
  83. register as visiting SysOp.  After approximately 24 hrs, you will
  84. be able to download the latest data and log-off  files,  also the
  85. latest door programs available.
  86.  
  87. Roland Haley
  88. Haley's Comment BBS
  89. (519) 469-3028 HST
  90. (519) 469-3173 2400b
  91.  
  92.